CxFmsHistoryGridCtrl Properties
The CxFmsHistoryGridCtrl object contains the following properties.
General Properties
Browse by letter: [A] [B] [C] [D] [E] [F] [H] [I] [M] [P] [R] [S] [U]
| Property | SubType | Read Only | Description |
|---|---|---|---|
|
Integer |
No |
Returns/sets the appearance of the object boundary Possible values for this property are as follows.
Default value is 0 - Flat. |
|
|
String |
No |
Note: This property is only used if the UseSessionOptions property is set to 0 - No. Returns/sets the starting date for the time window displayed in the control This string can be in one of the following forms.
Default value is T-7. See Selecting Date and Time for more information. Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control. |
|
|
Integer |
No |
Returns/sets the border style Possible values for this property are as follows.
Default value is 0 - None. |
|
|
String |
No |
Returns/sets the filter to be used, of the type specified by the ChooserFilterType property, when retrieving Nodes for selection Wildcard values * (multiple character) and ? (single character) are supported. Wildcards can be used in any part of the string to specify that any character or set of characters is allowed in its place. ExampleA filter string of “*Test*” will retrieve all Nodes with the word “Test” somewhere in the string, such as “TestDevice” or “MyTestDevice” or “Device001Test”. Default value is * (multiple character wildcard). |
|
|
Integer |
No |
Returns/sets the Node property type that will be filtered by the string specified in the ChooserFilterString property Possible values for this property are as follows.
Default value is 0 - Name. |
|
|
String |
No |
Returns/sets the group currently selected in the Node chooser’s Group combo box |
|
|
Integer |
No |
Returns/sets the Node category currently selected in the Node chooser’s Node category combo box Possible values for this property are as follows.
Default value is 8 - Node_Category2_Gas_Device. |
|
|
Boolean |
No |
Returns/sets whether or not the Node chooser’s Node category combo box is visible Possible values for this property are as follows.
Default value is 1 - Yes. |
|
|
Integer |
No |
Returns/sets the primary sort column of the Node chooser’s Node list Possible values for this property are as follows.
Default value is 2 - Name ascending. |
|
|
String |
No |
Returns/sets the Site.Service currently selected in the Node chooser’s FMS combo box |
|
|
Boolean |
No |
Returns/sets whether or not the Node chooser’s FMS combo box is visible Possible values for this property are as follows.
Default value is 1 - Yes. |
|
|
String |
No |
Returns/sets the XML specifying the custom FMS commands configured for the control Another way to configure this property is to use the control’s property page. |
|
| ColorExceptions |
Boolean |
No |
When a ColorGrid option other than "0 - None" is selected, returns/sets whether or not record rows with exceptions will be shown in color to indicate problematic data Possible values for this property are as follows.
Default value is 1 - Yes. |
| ColorGrid | Integer | No |
Returns/sets the grid color mode option used by the control Possible values for this property are as follows.
Default value is 1 - Row background. |
|
String |
No |
Returns/sets the XML specifying the columns that will be displayed in the control Another way to configure this property is to use the control-specific property page in the CygNet FMS Control Properties dialog box, on the Grid page. See CygNet FMS History Grid Control for more information. |
|
|
Integer |
No |
Returns/sets whether a Station Meter Node (a Gas Meter Node set to also function as a station) will display station or device level data in the control [supersedes the deprecated MeterStationView property] Possible values for this property are as follows.
Default value is 1 - Device_Mode. |
|
|
Integer |
No |
Note: This property is only used if the UseSessionOptions property is set to 0 - No. Returns/sets the format of the dates shown in the control Possible values for this property are as follows.
Default value is 0 - Device_Time. Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control. |
|
|
Integer |
No |
Returns/sets the number of decimal places that will be shown in the values displayed by the control Acceptable values include 0 - 10 decimal places. Default value is 7. |
|
|
String |
No |
Note: This property is only used if the UseSessionOptions property is set to 0 - No. Returns/sets the ending date of the data shown in the control This string can be in one of the following forms.
Default value is T. See Selecting Date and Time for more information. Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control. |
|
|
StdFont |
No |
Returns/sets the font used by the control Default value is MS Shell Dlg. |
|
|
StdFont |
No |
When a ColorGrid option other than "0 - None" is selected, returns/sets whether or not record cells triggering exceptions will be shown highlighted to indicate problematic data Possible values for this property are as follows.
Default value is 1 - Yes. |
|
|
Boolean |
Yes |
Returns whether or not the user is currently editing data in the FMS History Grid control |
|
|
String |
No |
Returns/sets the maximum data quality percentage below which results will be displayed in color in the control Color will be applied to records in the control with lower data quality than this selected value, according to the color mode value defined by the ColorGrid property. Possible values for this property are as configured in your system, via the Admin menu. See Configuring Data Quality Settings for more information. |
|
|
MeterStationView |
Integer |
No |
Note: This property deprecated in favor of DataMode
Returns/sets whether Station Meters will be displayed in the control as Stations or Devices See DataMode for details. |
|
String |
No |
Note: This property is only used if the UsePIT property is set to 1 - Yes. Returns/sets the Point in Time date and time of the FMS History Grid control This string can be in one of the following forms.
Default value is T, date and time today. See Using the Home Menu for more information about PIT mode. |
|
| RecordOrder | Integer | No |
Returns/sets the order in which records will be displayed in the FMS History Grid Possible values for this property are as follows.
Default value is 0 - Oldest_First. |
|
Integer |
No |
Return/sets the span of each record displayed in the control Possible values for this property are as follows.
Default value is 9999 - Native for Device data view, 60 - Hourly for Station data view. |
|
|
String |
No |
Note: This property is only used if the UseSessionOptions property is set to 1 - Yes. Returns/sets the Session starting date for the time window displayed in the control This string can be in one of the following forms.
See Selecting Date and Time for more information. Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control. |
|
|
Integer |
No |
Note: This property is only used if the UseSessionOptions property is set to 1 - Yes. Returns/sets the Session date/time format for the time window displayed in the control Possible values for this property are as follows.
Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control. |
|
|
String |
No |
Note: This property is only used if the UseSessionOptions property is set to 1 - Yes. Returns/sets the Session ending date for the time window displayed in the control This string can be in one of the following forms.
See Selecting Date and Time for more information. Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control. |
|
|
String |
No |
Note: This property is only used if the UseSessionOptions property is set to 1 - Yes. Returns/sets the Session Node tag, which specifies the active Node in the control This tag must be in the form SITE.SERVICE|ID (for example, TEST.FMS|2540). Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control. |
|
|
Boolean |
No |
Returns/sets whether or not the Chooser pane will be displayed in the control Possible values for this property are as follows.
Default value is 1 - Yes. |
|
|
Boolean |
No |
Returns/sets whether or not the Options pane will be displayed in the control Possible values for this property are as follows.
Default value is 1 - Yes. |
|
|
Boolean |
No |
Returns/sets whether or not units will be displayed in the control Possible values for this property are as follows.
Default value is 0 - No. |
|
|
String |
No |
Returns/sets the unit set used to determine the units of each FMS data item in the control Another way to configure this property is to use either the control’s property page or to use the Options page on the control. Default value is the <Default> unit set. |
|
|
Boolean |
No |
Returns/sets whether or not the PITDateTime property will be used Possible values for this property are as follows.
Default value is 0 - No. |
|
|
Boolean |
No |
Returns/sets whether to use the SessionNodeTag property [if set to 1 - Yes] or to present a Chooser page for Node selection [if set to 0 - No] to specify the active Node in the control Possible values for this property are as follows.
Default value is 1 - Yes for this control. Note: Default value varies by control type. |
|
|
Boolean |
No |
Returns/sets whether to use the SessionBeginDate, SessionEndDate, and SessionDateFormat properties [if set to 1 - Yes] in place of the BeginDate, EndDate, and DateFormat properties [if set to 0 - No] Possible values for this property are as follows.
Default value is 1 - Yes for this control. Note: Default value varies by control type. |


